[MZ] Сборник рецептов для добавления «ЭкшОна» в игру (и некоторые размышления)

**Darchan Kaen** · 30.03.2022, 19:00

Спойлер 2. Практическая часть:

Тут будет «сборник рецептов», представляющих собой функции, сохраненные в переменные мейкера. Часть из них можно использовать сами по себе, часть требует наличия других связанных функций. Повторюсь, при желании, все из этого можно вынести в отдельный плагин…по сути, это самый оптимальный вариант работы.

Большая часть кода практически использовалась в игре “ALWBAW”, ее же можно рассматривать как демо-версию – игра не зашифрована, ее можно открыть редактором (подбросив файл проекта MZ); если будете открывать – особый интерес представляют первые три «технические» карты и Общие события. Игру можно найти на данном форуме, на Светлой полосе, на Юнионе.
Если «рецепт» в реальной игре не тестировался – это будет указано отдельно.
Демо-игра также использует логику «сопартиец-как-патрон», что в рамках данного туториала рассматриваться не будет.

В существенной части рецептов используется применение скрипта в Маршруте эвента и тот факт, что на скорость исполнения маршрута влияет частота эвента. Также используется возможность хранения и записи текста в Примечании эвента. Кроме того, для ряда рецептов (прыжок, платформы) используется задание регионов на карте – во всех примерах корректным является регион с номером «1» (это тоже можно менять).

У каждого эвента-врага специальным образом заполнено Примечание и две страницы – первая, активируемая лок. переключателем «A» активная и вторая, активируемая лок. переключателем «B» не активная (враг уничтожен).
У эвентов-"пулек" и эвентов-"бомб" - три страницы, первая пустая не активная (но уже с нужной графикой!), вторая и третья как у эвентов-врагов

Номера функций в примерах кода взяты из игры, вы можете ставить любые. Код приводится в «сжатом» варианте – гарантированно влезает в команду «Скрипт» на MZ. Скриншотов не будет.
Код, как и логику что он реализует, может быть не оптимальна.

Спойлер Рецепт №1. «Прыжок с проверкой допустимости конечной точки»:

Цель:
Игрок прыгает на N-клеток вперед в сторону, которую повернут лицом (это называется «направление» в контексте мейкера) и только в том случае, если конечная точка допустима для приземления (чтоб не оказаться в стене, яме, итд). Направление передается из вызывающего кода.

Логика:
Согласно направлению и дальности прыжка, нужно узнать является ли конечная точка допустимым местом приземления. Для этого, исходя из направления, рассчитываются координаты корректной точки и проверяется ее номер ее региона.
В случае, если конечная точка нам подходит, то так как прыжок работает по разнице координат, мы получаем текущие координаты игрока, вычисляем разницу с конечными координатами и вызываем для игрока встроенную функцию прыжка по вычисленным значениям. В коде также вызывается дрожь экрана и SE-звук, причем отдельный звук в случаях прыжка и отказа.

Код функции Прыжка:

Код:

$gameVariables.setValue(10, (direction) => {
let jumpRadius = 3; let playerEndpointCoords = [];
if(8 === direction){ playerEndpointCoords = [$gamePlayer._x, $gamePlayer._y - jumpRadius];
}else if(6 === direction){ playerEndpointCoords = [$gamePlayer._x + jumpRadius, $gamePlayer._y];
}else if(4 === direction){ playerEndpointCoords = [$gamePlayer._x - jumpRadius, $gamePlayer._y];
}else if(2 === direction){ playerEndpointCoords = [$gamePlayer._x, $gamePlayer._y + jumpRadius];
}
let playerEndpointRegionId = $gameMap.regionId(playerEndpointCoords[0], playerEndpointCoords[1]);
if(1 === playerEndpointRegionId){
let jumpCoordX = playerEndpointCoords[0] - $gamePlayer._x;
let jumpCoordY = playerEndpointCoords[1] - $gamePlayer._y;
if(undefined !== jumpCoordX && undefined !== jumpCoordY){
$gamePlayer.jump(jumpCoordX, jumpCoordY);
$gameScreen.startShake(7, 7, 15); AudioManager.playSe({ name: 'Earth1', volume: 60, pitch: 100, pan: 0 });
}else{ AudioManager.playSe({ name: 'Buzzer1', volume: 60, pitch: 100, pan: 0 }); }
}else{ AudioManager.playSe({ name: 'Buzzer1', volume: 60, pitch: 100, pan: 0 }); }
});

Что можно улучшить:
Можно задать динамическую дальность прыжка, храня «радиус» в отдельной переменной. Можно сделать так, что в случае некоррктности конечной клетки, проверяется корректность предыдущий…и игрок прыгает хоть как-то. Можно хранить стартовые (до-прыжковые) координаты игрока в отдельной переменной.

Спойлер Рецепт №2. «Клонирование эвента с его последующей активацией»:

Цель:
Создать новый эвент программно, по образцу уже существующего. При этом существующий эвент «не активен», т.е. первая страница пуста, а для работы он требует включеный локальный переключатель «A». При этом новый эвент создается по конкретным координатам с конкретным направлением. Id эвента для копирования, необходимые координаты и направление передаются из вызывающего кода.

Логика:
Копируем эвент, задаем ему новый случайный Id (цифры 1000 и 500 произвольны и исходят из кол-во ОБЫЧНЫХ, не клонированных, эвентов на карте), вставляем его в массивы эвентов игровые объектов $dataMap и $gameMap (для второго предварительно нужно создать новый «игровой» эвент), задаем новому эвенту направление, перемещаем в координаты, включаем у него «активный» локальный переключатель и обновляем графику всех эвентов на карте (сцене), тем самым делая клонированный эвент видимым.

Код функции Клонирования:

Код:

$gameVariables.setValue(5, (eventToCloneId, cloneInCoordX, cloneInCoordY, cloneInDirection) => {
let eventToCloneData = $dataMap.events[eventToCloneId]; 
let clonedEventData = {...eventToCloneData};
let newId = eventToCloneId + Math.floor(Math.random() * 1000 + 500); 
if($dataMap.events.length < newId){ $dataMap.events.length = newId; }
$dataMap.events[newId] = clonedEventData;
let clonedMapEvent = new Game_Event(this._mapId, clonedEventData.id);
clonedMapEvent._direction = cloneInDirection;
clonedMapEvent.locate(cloneInCoordX, cloneInCoordY);
$gameMap._events.push(clonedMapEvent);
$dataMap.events[$dataMap.events.length - 1].id = newId; 
$gameMap._events[$gameMap._events.length - 1]._eventId = newId;
$gameSelfSwitches.setValue([$gameMap._mapId, newId, 'A'], true);
SceneManager._scene._spriteset.createCharacters();
});

Что можно улучшить:
Вероятно, можно улучшить генерацию случайного Id для нового эвента, введя доп. проверки на наличие таких Id.

Спойлер Рецепт №3. «Понижение ХП игрока, урон по игроку»:

Спойлер Рецепт №4. «Шипы»:

Спойлер Рецепт №5. «Движущиеся платформы»:

Спойлер Рецепт №6. «Жив ли враг»:

Спойлер Рецепт №7. «Уменьшение ХП врага»:

Цель:
Уменьшение характ-ки ХП эвента-врага. Id врага-эвента задается извне, как и урон.

Логика:
Получаем Примечание нужного эвента (по его Id), парсим и читаем Примечание, уменьшаем ХП, записываем обратно в Примечание эвента.
Если ХП в результате меньше 0, то показываем на врага анимацию, включаем его «побежденный» переключатель «B», делая его тем самым неактивным, и приплюсовываем к переменной для кол-ва уничтоженных врагов единицу (если номер переменной равен 0, он игнорируется мейкером).
ХП возвращается из ф-ии, т.к. это нужно для "бомбы".

Код функции Уменьшения ХП врага:

Код:

$gameVariables.setValue(3, (enemyEvent, damageValue = 1) => {
let enemyData = $dataMap.events[enemyEvent._eventId].note;
if(0 === enemyData.length){ return false; }
let enemyDataObj = JSON.parse(enemyData);
let enemyHp = parseInt(enemyDataObj.hp);
if(0 === enemyHp ){ return false; } 
enemyHp -= damageValue;
enemyDataObj.hp = enemyHp;
$dataMap.events[enemyEvent._eventId].note = JSON.stringify(enemyDataObj);
if(enemyHp <= 0){ 
if('ENEMY' === enemyDataObj.type){ $gameTemp.requestAnimation([enemyEvent], 58); }
$gameSelfSwitches.setValue([$gameMap._mapId, enemyEvent._eventId, 'B'], true);
let countVarId = parseInt(enemyDataObj.countVarId); $gameVariables.setValue( countVarId, ($gameVariables.value(countVarId) + 1) );
}
return enemyHp; 
});

Что можно улучшить:
Проверку по ХП. Возможно, добавить в «объект врага» кроме переменной – включение какого-то переключателя, это может быть полезно для Боссов.

Спойлер Рецепт №8. «Удар игроком врага в ближнем бою»:

Цель:
Возможность для игрока атаковать эвент, находящийся в небольшой радиусе с ним, уменьшая его ХП.

Логика:
Логика делится на две части:
1) Получения массива координат, в которых будет проходить поиска врагов; это и есть дальность и «радиус» удара; тут он не только перед игроком, но еще и по диагонали влево и вправо – для удобства. Массивы высчитывается исходя их координат игрока и его направления.
2) По найденному массиву координат проходимся циклом, записываем его в массив найденных врагов. После чего проходимся уже по нему и для каждого найденного врага, проверяем жив ли он, и если да – наносим урон по эвенту-врагу и проигрываем анимацию.
Перед вызовом скрипта с кодом атаки в ближнем бою, опционально, можно проиграть анимацию средствами команд мейкера.

Код атаки врага в ближнем бою:

Код:

let getCoordsList = $gameVariables.value(1); let isEnemyyAlive = $gameVariables.value(2)
let changeEnemyHP = $gameVariables.value(3);
let coordsList = getCoordsList($gamePlayer); 
let enemiesList = [];
for(let n = 0; n < coordsList.length; n++){
let currentEnemy = $gameMap.eventsXy(coordsList[n][0], coordsList[n][1]);
if(currentEnemy.length > 0){
enemiesList.push(currentEnemy[0]);
}
} 
enemiesList.forEach(enemy => { 
if(true === isEnemyyAlive(enemy)){
$gameTemp.requestAnimation([enemy], 1); 
changeEnemyHP(enemy); 
}
});

Код функции Получения массива координат перед игроком:

Код:

$gameVariables.setValue(1, (player) => {
let direction = player._direction;
let coordsList = [];
if(8 === direction){
coordsList = [ [player._x - 1, player._y - 1], [player._x, player._y - 1], [player._x + 1, player._y - 1] ];
}else if(6 === direction){
coordsList = [ [player._x + 1, player._y - 1], [player._x + 1, player._y], [player._x + 1, player._y + 1] ];
}else if(4 === direction){
coordsList = [ [player._x - 1, player._y - 1], [player._x - 1, player._y], [player._x - 1, player._y + 1] ];
}else if(2 === direction){
coordsList = [ [player._x - 1, player._y + 1], [player._x, player._y + 1], [player._x + 1, player._y + 1] ];
}
return coordsList;
});

Что можно улучшить:
Можно сделать несколько видов оружия ближнего боя и, в зависимости от выбранного оружия, менять массив координат для урона (оружие бьет вокруг, бьет с дальностью 2 клетки, бьет букой «Г», итд).

Спойлер Рецепт №9. «Удар врагом игрока в ближнем бою»:

Цель:
Эвент-враг атакует игрока, находящегося рядом, понижая его ХП.

Логика:
Логика схожа с логикой удара игроком эвента.
Сначала, исходя из координат атакующего эвента, получаем массив возможных координат атаки (функция в Рецепте №9).
После чего для каждого варианта координат сверяем, совпадают ли они с координатами игрока и если да, то проигрываем на игрока анимации и снижаем его ХП. Опционально, в зависимости от направления эвента, проигрывается анимация «взмаха» оружием.
Все это делает эвент-враг функцией, которую вызываем в маршруте (например: повторяющиеся шаг к игроку и вызов функции).
Мне показалось, что оптимальная частота здесь не максимальная, а высокая.

Код для маршрута:

Код:

let meleeEnemyAttack = $gameVariables.value(11); meleeEnemyAttack(this);

Код функции Атаки врагом игрока в ближнем бою:

Код:

$gameVariables.setValue(11, (enemyEvent) => {
let getCoordsList = $gameVariables.value(1);
let damagePlayer = $gameVariables.value(9);
let coordsList = getCoordsList(enemyEvent);
let direction = enemyEvent._direction;
for(let n = 0; n < coordsList.length; n++){
if(coordsList[n][0] === $gamePlayer._x && coordsList[n][1] === $gamePlayer._y){
if(8 === direction){ $gameTemp.requestAnimation([enemyEvent], 122); 
}else if(6 === direction){ $gameTemp.requestAnimation([enemyEvent], 125); 
}else if(4 === direction){ $gameTemp.requestAnimation([enemyEvent], 124); 
}else if(2 === direction){ $gameTemp.requestAnimation([enemyEvent], 123); 
}
$gameTemp.requestAnimation([$gamePlayer], 1); 
damagePlayer();
}
} 
});

Что можно улучшить:
Если будет несколько типов врагов ближнего боя, для них можно сделать разные массивы координат (разные дальность и радиус удара).

Спойлер Рецепт №10. «Выстрел игрока и/или врага»:

Спойлер Рецепт №11. «Тикающая бомба»:

Цель:
При активации скрипта, на месте игрока / врага создается эвент-бомба, «взрывающийся» через некоторое количество времени.

Логика:
Логика схожа с логикой выстрела, т.к. для клонирования используется специальный объект-«часовая бомба», у которой тоже маршрут со скриптом, и которая тоже наносит себе же урон. При достижении 1 ХП и происходит «взрыв», нанося урон всем (и игроку, и эвентам-врагам) в заданном радиусе.
А еще бобма прыгает в процессе "тикания".

Код для «призыва бомбы»:

Код:

$gameVariables.setValue(15, (enemyEvent) => {
const EVENT_TO_SPAWN_ID = $gameVariables.value(28);
let getFaceSideCoords = $gameVariables.value(4);
let spawnEvent = $gameVariables.value(5); 
let direction = enemyEvent._direction;
let coordsForSpawn = getFaceSideCoords(enemyEvent);
spawnEvent(EVENT_TO_SPAWN_ID, coordsForSpawn[0], coordsForSpawn[1], direction);
AudioManager.playSe( { name: 'Bite', volume: 90, pitch: 100, pan: 0 } );
});

Код для маршрута «бомбы»:

Код:

let tickBombEvent = $gameVariables.value(7); tickBombEvent(this);

Код функции Тикания «бомбы»:

Код:

$gameVariables.setValue(7, (bombEvent) => { let isEnemyAlive = $gameVariables.value(2); let decreaseHp = $gameVariables.value(3);
let hp = decreaseHp(bombEvent); bombEvent.jump(0, 0); 
let bombRadius = [ [bombEvent._x - 1, bombEvent._y - 1], [bombEvent._x, bombEvent._y - 1], [bombEvent._x + 1, bombEvent._y - 1],
[bombEvent._x - 1, bombEvent._y], [bombEvent._x, bombEvent._y], [bombEvent._x + 1, bombEvent._y],
[bombEvent._x - 1, bombEvent._y + 1], [bombEvent._x, bombEvent._y + 1], [bombEvent._x + 1, bombEvent._y + 1], ];
let enemiesList = [];
if(1 === hp){
$gameTemp.requestAnimation([bombEvent], 66); 
for(let n = 0; n < bombRadius.length; n++){
let currentEnemy = $gameMap.eventsXy(bombRadius[n][0], bombRadius[n][1]);
if(currentEnemy.length > 0){
enemiesList.push(currentEnemy[0]);
}
if(bombRadius[n][0] === $gamePlayer._x && bombRadius[n][1] === $gamePlayer._y){
let damagePlayer = $gameVariables.value(9); damagePlayer();
$gameTemp.requestAnimation([$gamePlayer], 1); 
}
} console.log('enemiesList:', enemiesList);
enemiesList.forEach(enemy => { 
if(true === isEnemyAlive(enemy)){
$gameTemp.requestAnimation([enemy], 1); 
decreaseHp(enemy, 3); 
}
});
}
});

Что можно улучшить:
Не знаю, мне просто нравится как это работает.

Спойлер Рецепт №12. «Вывод информации»:

Спойлер Рецепт №DKR. «Бонус»:

Что еще можно сделать:
«Не вошедшее»
Бумеранг. Отражение «пулек» обратно в точку их старта. Телепорт-«крюк».
И все, на что вам хватит фантазии и силы в борьбе с мукером.